home *** CD-ROM | disk | FTP | other *** search
/ Utilities Professional 1-1500 / Utilities Professional 1-1500 (1994)(WPD)[!].iso / 12511500 / var1436.dms / var1436.adf / ABank_English / ABank.doc < prev    next >
Text File  |  1994-06-19  |  15KB  |  432 lines

  1.  
  2.  
  3.           ABank                                  Programming
  4.           version 1.01                             David Gaussinel
  5.           © 1994 David Gaussinel                 Graphics
  6.                                                    Stéphane Anquetil
  7.                                                  English translation
  8.                                                    Christophe Carel
  9.  
  10.           1. Introduction                        5. Menus' description
  11.           1.1 Overview                           5.1 Project
  12.           1.2 Greetings                          5.2 Edition
  13.                                                  5.3 Tools
  14.           2. General                             5.4 Preferences
  15.           2.1 Warning                            5.5 Accounts
  16.           2.2 Distribution
  17.           2.3 Copyrights                         6. AGIP compatibility
  18.  
  19.           3. How to install ABank ?              7. Bugs
  20.  
  21.           4. Using ABank                         8. Improvements
  22.  
  23.                              9. History
  24.  
  25. 1. Introduction
  26.  
  27. 1.1 Overview
  28.  
  29.    ABank is a domestic  bank account software. The idea is simple. When you
  30. make an operation on your account, you signal  it to the software which up-
  31. date permanently your account state.
  32.  
  33.    ABank can load simultaneously more than ten accounts, automatically sor-
  34. ting the  operations, possessing a  notepad, loads powerpacked files, makes
  35. graphical stats, printing with filter and is AGIP compatible.
  36.  
  37.    Domestic bank account softwares are very numerous, as much in the public
  38. domain as  in the commercial domain. But  when they aren't  adapted from PC
  39. versions, they are often bad looking or let you make not many things. It is
  40. the reason I've never used until today this kind of  programs. However, the
  41. using seemed interesting. To have the  possibility to control your bank ac-
  42. count,  knowing where the  balance is in  reality without phoning to a bank
  43. service, to see where I spent the most, ...
  44.  
  45.    Therefore, ABank has been written in the goal to success all of that. To
  46. allow the user to know everything, everyday, about its account, and by a
  47. pleasant way if it comes to that.
  48.  
  49.  
  50. 1.2 Greetings
  51.  
  52.  - François Lionet
  53.       for Amos, Amos Pro, compilers ...
  54.       for his sympathy when phoning.
  55.  
  56.  - Stéphane Anquetil, called Sada
  57.       for his good drawings.
  58.  
  59.  - Arnaud Danassié
  60.       for his fidelity, even if he must do his military service like me.
  61.  
  62.  - Guillaume Jay
  63.       To not vex him about being forgotten, and to make him programming
  64.       SERIOUSLY
  65.  
  66.  - Jean-Pierre Rivière
  67.       To be the ant worker of Belier Production
  68.  
  69.  - And all others,  members of Atacom, Buggs,  Belier Production,  Amitels'
  70.    subscribers, and all others who make the Amiga a big family.
  71.  
  72.  
  73. 2. General
  74.  
  75. 2.1 Warning
  76.  
  77.    In spite of numerous tests, I can't guarantee that ABank contains no er-
  78. rors. You use this  program at your  own risk. I won't  be in charge if the
  79. use of ABank is responsible for any direct or indirect damages.
  80.  
  81. 2.2 Distribution
  82.  
  83.    ABank is shareware. In this  demo version,  you can't enter more than 50
  84. operations.  To own the complete  version of this  product, you must send a
  85. contribution, at less than FF75 to the author :
  86.  
  87.                               David Gaussinel
  88.                               18 rue Fénelon
  89.                                24200 Sarlat
  90.                                   FRANCE
  91.                              Tel: 53.59.34.70
  92.  
  93.    You will receive a key file that any version of ABank will recognize and
  94. which identify yourself as a registered user. From this date,  you will may
  95. update ABank without going through the author, to get the last version.
  96.  
  97.    The ABank demo version,  I mean the one  without the key file ("key") is
  98. freely distributable. It may be distributed in a PD collection, on servers,
  99. networks. However, the cost to get the program  mustn't exceed the expenses
  100. engaged.  But the distribution  of this program by a magazine on its cover-
  101. disk should be transmit to the author's agreement.
  102.  
  103. 2.3 Copyrights
  104.  
  105.    ABank is copyrighted 1994 David Gaussinel.
  106.  
  107.    Amos Pro is copyrighted 1992 Europress Software Ltd.
  108.  
  109.    AGIP  (Amos  Global  Interface  Protocol)  is  copyrighted  1994  David
  110. Gaussinel.
  111.  
  112.    The PowerPacker.library is copyrighted Nico François.
  113.  
  114.    Amiga and Workbench are trademarks of Commodore Amiga Inc.
  115.  
  116.    All products or  mentioned brands are  registered by  their  respective
  117. owner.
  118.  
  119.  
  120. 3. How to install ABank ?
  121.  
  122.   To install ABank, first copy Amos and powerpacked libraries in your Libs:
  123. directory if it wasn't done before.
  124.    You can assign ABank: in the  directory where ABank is, if you want. Be-
  125. sides, take care to run ABank in his home directory. Anyway, from the Work-
  126. bench, it is automatically done.
  127.  
  128.    ABank must find the Datas directory in ABank: or in the current directo-
  129. ry. In this  Datas directory,  there is the default icon for accounts (Def-
  130. Icon.info)  that you can  modify if  you  want, and  the BLogos  and CLogos
  131. drawers which contain banks and accounts logos (in IFF format in 48*24 with
  132. 8 colors in Med-Res mode).
  133.  
  134.    Don't worry about this if you don't understand anything and double click
  135. on the ABank icon.
  136.  
  137. 4. Using ABank
  138.  
  139.    Once ABank run, the main screen appears. If you aren't a registered user
  140. a request  appears which tells you.  Click on Continue and you are ready to
  141. use this program.
  142.  
  143.    At the right top corner, there is a deep gadget which lets you come back
  144. to the Workbench. To be back in ABank, you must press the keys Left Amiga +
  145. A (A as ABank).
  146.  
  147.    You can see on the screen many fields clearly delimited. At the top, th-
  148. ere are  some informations about the current  account, next to the balance,
  149. credits, debits... of your account. At the top, there are equally a  set of
  150. gadgets, making the same effect than menus but being faster to use. Lastly,
  151. at  the bottom,  there is the list  of done  operations, with date, nature,
  152. item, debit/credit, and the potential validation of the bank.
  153.  
  154.    We will come back in detail to all of these notions through Menus' descrip-
  155. tion.
  156.  
  157. 5. Menus' description
  158.  
  159. 5.1 Project menu
  160.  
  161. 5.1.1 Open new
  162.  
  163.    This option lets you, after confirmation,  create a new account. The ac-
  164. count's edition panel will be displayed, allowing you to enter different in-
  165. formations asked.
  166.  
  167.    See the account's edition menu {5.2.5}.
  168.  
  169. 5.1.2 Load
  170.  
  171.    ABank can  load simultaneously  different accounts.  This option lets you
  172. load on the current account's behalf, another account from a disk.
  173.  
  174. 5.1.3 Open and Load
  175.  
  176.    ABank can load simultaneously different accounts.  This option lets you
  177. load a new account. The current account is already in memory and then acce-
  178. ssible from the Account menu.
  179.  
  180.    See Account menu {5.5}.
  181.  
  182. 5.1.4 Save
  183.  
  184.    ABank will save your account as the  name mentioned before when you loa-
  185. ded it. If ABank doesn't recognize this name, it will ask you a new name by
  186. a file request way.
  187.  
  188. 5.1.5 Save as...
  189.  
  190.    ABank will save  your account just after asking you a new name through a
  191. file request.
  192.  
  193. 5.1.6 Close
  194.  
  195.    ABank will delete after  confirmation the  current account in memory. If
  196. there are other accounts opened, ABank 'll display another account, or else
  197. you 'll find a blank account.
  198.  
  199. 5.1.7 User
  200.  
  201.    If you are  a registered  user, your  names and address are displayed in
  202. this request, else the  program tells you that  you 're not registered, and
  203. then you 're using the demo version.
  204.  
  205.    This option is also accessible from a gadget.
  206.  
  207. 5.1.8 About ...
  208.  
  209.    By this, the program's ID will be  displayed, telling you the  program's
  210. name, version, diffusion  status, author's name.  There are also two logos,
  211. one showing the AGIP compatibility and the other indicating that ABank  was
  212. written in Amos.
  213.  
  214. 5.1.9 Quit
  215.  
  216.    After confirmation, this option allows you to quit the program.
  217.  
  218. 5.2 Edition menu
  219.  
  220. 5.2.1 Add
  221.  
  222.     This option adds an operation to the others.  A request appears, allow-
  223. ing you to enter the date  (following the ddmm format), operation's nature,
  224. debit or credit, if the operation was validated or not by the bank  (I mean
  225. if the bank's statement notifies it), and the choosen item.
  226.  
  227.    To modify an operation, just click on it.
  228.  
  229.    This option is also accessible from a gadget.
  230.  
  231. 5.2.2 Delete
  232.  
  233.    To delete an operation, you must first active this option and then click
  234. on the operation desired. Don't forget desactivating this option once desi-
  235. red operations are deleted.
  236.  
  237.    This option is also accessible from a gadget.
  238.  
  239. 5.2.3 Sort
  240.  
  241.    Normally,  operations are sorted  on each  modification, but if you wish
  242. to make a sorting yourself, choose this option.
  243.  
  244.    This option is also accessible from a gadget.
  245.  
  246. 5.2.4 Validate
  247.  
  248.    Next to credit/debit, a sign `\' is present, notifying the potential va-
  249. lidation by the bank. Just click on it to validate or unvalidate the opera-
  250. tion.
  251.  
  252.    This sub menu Validate has three options to go faster.
  253. All will validate all operations,  None will unvalidate  all operations and
  254. Reverse will inverse all operations (all validated won't be and vice-versa).
  255.  
  256. 5.2.5 Account
  257.  
  258.    This option lets you configure your account.
  259.  
  260.    Three gagdets permit to enter the owner's name of the account, account's
  261. number and account's type. Those infos  will be displayed soon on  the main
  262. screen.
  263.    ABank manages the account from  a  year (It's  the reason dates are only
  264. displayed  on  the ddmm format). However, you can enter a start balance for
  265. the account.  All operations  will take in account what it  has been at the
  266. beginning  of the year, on the account.
  267.    It's also from  this that you enter the threshold. When a balance is in-
  268. ferior to this threshold, it will be written into a different color to  warn
  269. you.
  270.  
  271.    You equally may choose in the list your bank's logo and  another one for
  272. your account.  You choose between  two lists; bank logo and account logo by
  273. clicking on the cyclic gadget at the top of the list.
  274.  
  275.    This option is also accessible from a gadget.
  276.  
  277. 5.2.6 Items
  278.  
  279.    Items of a budget let you sort  your operations. Through  this menu, you
  280. can modify the items' list (adding, deleting,...).
  281.  
  282.    The request explains itself.
  283.  
  284.    This option is also accessible from a gadget.
  285.  
  286. 5.2.7 Notepad
  287.  
  288.    Notepad is... a notepad ! You may note inside whatever you feel and want.
  289. Also think to write your credit cards numbers for example or telephone num-
  290. ber of your bank, or ...
  291.  
  292.    The request explains itself.
  293.  
  294.    This option is also accessible from a gadget.
  295.  
  296. 5.3 Tools menu
  297.  
  298. 5.3.1 Stats
  299.  
  300.    This option  lets you get  a  pie chart,  describing your operations per
  301. item.
  302.    A cyclic gadget lets you define if you want : credit or debit, and other
  303. selects  either a month  or all the year. Following this selection, propor-
  304. tions of each item are displayed with a legend next to the pie chart.
  305.  
  306.    A menu quickly selects a specific month.
  307.  
  308.    This option is also accessible from a gadget.
  309.  
  310. 5.3.2 Annual balance
  311.  
  312.    A bar chart  is displayed suggesting  the distribution following monthes
  313. of debits and credits. You can see through this chart, what are the monthes
  314. where you have spent most, as an example.
  315.  
  316.    This option is also accessible from a gadget.
  317.  
  318. 5.3.3 Print
  319.  
  320.    This option lets you print your account by making a filter. Effectively,
  321. you can choose to print only certain things. A first cyclic gadget lets you
  322. select  only validated operations, unvalidated ones or both, indifferently.
  323. Another gadget lets you  select operations of a particular month  or of all
  324. the year.  Lastly, a  list lets you choose  a particular item  or all items
  325. without distinction.
  326.  
  327.    This option is also accessible from a gadget.
  328.  
  329. 5.4 Preferences menu
  330.  
  331. 5.4.1 Interlace screen
  332.  
  333.    When this option is active, the screen will be interlaced,  meaning that
  334. height is doubled  but unfortunately with an  unpleasant flickered image if
  335. you don't possess a flicker fixer.
  336.  
  337.    In  interlaced  mode, the number of visible operations will be more than
  338. doubled.
  339.  
  340. 5.4.2 Separate thousands
  341.  
  342.    If  this option is active,  numbers will be separated by a space between
  343. thousands, for a best reading.
  344.  
  345. 5.4.3 Save icon
  346.  
  347.    If this option is active when an account is saved, an icon is also saved.
  348.  
  349. 5.4.4 Configure
  350.  
  351.    This option calls the AGIP editor if  AGIP has been already installed in
  352. your system. The AGIP editor  (AGIP_Ed) lets you entirely  define program's
  353. work environment (menus, pointers, appearance, tests,...).
  354.  
  355.    See AGIP {6} for more details.
  356.  
  357. 5.5 Accounts menu
  358.  
  359.    ABank lets you have simultaneously in memory up to ten accounts. In this
  360. menu,  there will be displayed : names  of different  accounts currently in
  361. memory; the current account is marked with a small sign. Then you can choose
  362. another account from this menu to make it the current account.
  363.  
  364. 6. AGIP
  365.  
  366.    AGIP is a system enabling to entirely control a program's interface if it
  367. is compatible. AGIP is not supplied with ABank. You should find it easily in
  368. the public domain, else contact the author by sending a blank disk and a st-
  369. amped envelope with your address :
  370.  
  371.                               David Gaussinel
  372.                               18 rue Fénelon
  373.                                24200 Sarlat
  374.                                   FRANCE
  375.                              Tel: 53.59.34.70
  376.  
  377.    If AGIP is already installed, just move the ABank.AGI module in AGIP:Mo-
  378. dules/ as explained in the AGIP documentation. It is not necessary to poss-
  379. ess AGIP to run  this program but if AGIP is installed, you  may modify the
  380. whole program's interface, I mean menus, texts, gadgets, appearance, inter-
  381. face's structures, and even the pointers.
  382.  
  383.    AGIP is freeware,  meaning Amos Global Interface Protocol and is copyri-
  384. ghted 1994 David Gaussinel.
  385.  
  386.    If you have created  a new interface, don't hesitate  sending the module
  387. to the author.
  388.  
  389. 7. Bugs
  390.  
  391.    Is a program  without bugs realizable ? I don't  think so. Therefore, if
  392. you find a bug (or many), write to the author, even if you're not a regist-
  393. ered user.
  394.  
  395. 8. Improvements
  396.  
  397.    I will be very clear and rough, ABank won't be improved if no many users
  398. will register.  Why continue to  program a software if  nobody wants to see
  399. improvements ? Therefore, if you want improvements, think to register your-
  400. self.
  401.  
  402.    Improvements may be added to ABank, such as :
  403.  
  404.  - Accounts exportation in Ascii
  405.  - Accounts importation of other programs
  406.  - other kinds of charts
  407.  - charts exportation
  408.  - cheque-books administration
  409.  - An ARexx port
  410.  
  411.    But, as said before, all of this will happen only if you, user, wish it.
  412.  
  413. 9. History
  414.  
  415.    ~ Version 1.0  (03.25.94)
  416.  
  417.    First version spread. Preceded by many alpha and beta versions.
  418.  
  419.    ~ Version 1.01 (06.14.94)
  420.  
  421.    Re-write of the code using the CRAFT © Black  Legend  Software & Solaris
  422. Software extension.
  423.  
  424.    Repaired error, when printing a whole account.
  425.  
  426.    When an account is loaded, it's now replaced at the same position it was
  427. when it was saved.
  428.  
  429.    Each account is saved, and then reloaded, with its own prefs.
  430.  
  431.    English version of ABank by Christophe Carel.
  432.